SGGetChannelPlayFlags(IM: QC)

Inside Macintosh: QuickTime Components /

Chapter 5 - Sequence Grabber Components / Sequence Grabber Components Reference

Sequence Grabber Component Functions / Working With Channel Characteristics

SGGetChannelPlayFlags
The SGGetChannelPlayFlags function allows you to retrieve the playback control flags that you set with the SGSetChannelPlayFlags function, which is described in the previous section.
pascal ComponentResult SGGetChannelPlayFlags (SGChannel c, 
                                              long *playFlags);
c
Specifies the reference that identifies the channel for this operation. You obtain this reference from the SGNewChannel function, described on page 5-29.
playFlags
Contains a pointer to a long integer that is to receive flags that influence channel playback. The following values are defined:
channelPlayNormal
The channel component uses its default playback methodology.
channelPlayFast
The channel component sacrifices playback quality in order to achieve the specified playback rate.
channelPlayHighQuality

The channel component plays the channel's data at the highest possible quality--this option sacrifices playback rate for the sake of image quality. This option may reduce the amount of processor time available for recording. This option does not affect the quality of the recorded data, however.

The following flag is defined and may be used with any of the values defined for this parameter (unused flags are set to 0):
channelPlayAllData
The channel component tries to play all of the data it captures, even the data that is stored in offscreen buffers. This option is useful when you want to be sure that the user sees as much of the captured data as possible.